(c)Copyright 2003-2005 Marvell(R).
All rights reserved.

=============================================================================


m4cxosx.txt created 15-Mar-2005

Readme File for m4cxosx.pkg v6.12.1.3

D-Link DGE-530T Gigabit Ethernet Adapter 


This file contains 

  1  Overview 
  2  Required files 
  3  Installation 

    3.1  Installation of driver software 
    3.2  Network configuration 
    3.3  Deinstallation of the driver software 

  4  Parameters 

    4.1  Driver Class Parameters 
    4.2  Driver Instance Parameters 







1  Overview 
This network device driver is designed for use with
Apple Mac OS X versions 10.2 and 10.3 on Apple
PowerPC hardware with multiple PCI expansion slots.

CAUTION: There is no guarantee that the software will
         work correctly, or even install correctly, on
         operating system releases prior to 10.2.



2  Required files 
The following file is required for a correct install
of the driver software: m4cxosx.pkg.sit
This file should be on the driver CD-ROM which came
with the adapter.
If this file is not on the CD-ROM, please download
the latest driver version from your vendor's web site.


3  Installation 
This section describes the installation of the driver
software using the Mac OS X Software Installer
program.

NOTE: Please note that you must have administrator
      privileges to install system software such as
      this driver. If you are not the administrator
      of your computer (eg. if you are not the owner
      of your computer, or you did not install the
      Mac OS X software yourself, it is likely that
      you are NOT the administrator), please contact
      your system administrator for advice on how to
      proceed.
      Please check the Mac OS X documentation for
      information on how to obtain administrator
      privileges.


3.1  Installation of driver software 

To unpack the driver package, proceed as follows:

1. Insert the driver CD-ROM into the CD-ROM drive.

2. Locate the m4cxosx.pkg.sit file on the CD_ROM.

3. Drag or copy the m4cxosx.pkg.sit file to the
   folder where you want to unpack the software.

4. Double-click on the m4cxosx.pkg.sit file icon.

5. You should now have the unpacked driver package,
   which is called m4cxosx.pkg in your folder.
   The icon is a translucent yellow cube in an opened
   cardboard box.

6. Double-click on the m4cxosx.pkg file icon.
   This will start the software installer program.

7. Click on 'Continue'

8. Enter the name of an administrator and the
   associated password. If you have administrator
   privileges, enter your username and password here.
   If you do not have administrator privileges, please
   contact your system or network administrator for
   help.

9. Click on 'OK' or press Return.

10. Click on 'Continue' to get to the section on the
    left hand side of the window named 'Select
    Destination'.

11. Select the disk where you want to install the
    driver software by clicking on its icon.

CAUTION: Please select the disk where Mac OS X is
         installed. This disk should have a folder
         marked 'System' on it. DO NOT select other
         disks which do not have this folder. The
         system will not find the driver and the
         software will not work.

12. Click on 'Continue'.

13. In the next window click on 'Install' to perform
    the installation.

14. The software requires a restart of your computer
    to function properly. If this is inconvenient at
    this time, click on 'Cancel' and close the
    Installer application. You may restart the
    Installer application later.
    To continue with the installation, click on
    'Continue Installation'.

15. Click on the 'Restart' button to restart your
    computer. The software is now correctly installed.

16. For proper network configuration proceed with the
    chapter 'Network configuration' below.


3.2  Network configuration 

1.  Open the menu "System Preferences" on the control
    panel.

2.  Click on the "Network" Icon.
    The network configuration menu opens.

3.  If you did not configure your network interface
    yet the system tells you that a new network
    interface card has been found on the PCI bus.
    You will be prompted for configuration.

4.  Select the corresponding "PCI Ethernet Slot" in
    the "Show" list box. Select the TCP/IP tab below
    and configure the TCP/IP network configuration. 

5.  Confirm your network configuration by exiting with
    the "Apply Now" button. Your network interface is
    now operational.



3.3  Deinstallation of the driver software 

To remove the software from your computer, please
carry out the following steps:

1. Double-click on the disk on which you installed the
   driver software (the system disk).

2. Double-click on the 'System' folder.

3. Double-click on the 'Library' folder.

4. Double-click on the 'Extensions' folder.

5. Drag the folder or icon marked m4cxosx.kext
   to the waste paper basket on the control panel.

6. Go back to the top level folder and double-click
   on the 'Library' folder.

7. Double-click on the 'Receipts' folder.

8. Drag the folder or icon marked m4cxosx.pkg
   to the waste paper basket on the control panel.



4  Parameters 
There are a number of parameters that may be modified
to activate or deactivate particular driver features.
Motivation for this includes performance optimisation
and compatibility with Gigabit Ethernet switch
settings, such as flow control or duplex.

There are two types of parameters: per-class and per-
instance. The per-class parameters are set in the
XML configuration files and should only be modified
by experienced personnel, if at all.
The per-instance parameters are considerably more
useful and accessible.


4.1  Driver Class Parameters 

The per-class settings for each adapter type are in an
XML-formatted file called 'Info.plist' in the
/System/Library/Extensions/m4cxosx.kext/Contents
folder. This file can be edited with a standard text
editor (vi, Emacs, etc) or with an XML editor.

NOTE: The modification of these driver settings is NOT
      usually necessary and requires considerable
      knowledge of networking functionality, hardware
      and software. If you do not know what each
      parameter does, DO NOT modify it!
      Setting the wrong values can substantially
      degrade the performance of your system.

The parameters available are:

Name                         Default   Possible values
----                         -------   ---------------
RxRingSize                   256       Minimum 128,
                                       Maximum 1024
TxRingSize                   256       Minimum 50,
                                       Maximum 512

Description of device parameters:

RxRingSize
----------

Description:  Sets the number of descriptors in the
              receive ring.

TxRingSize
----------

Description:  Sets the number of descriptors in the
              transmit ring.


4.2  Driver Instance Parameters 

This section describes how to modify the per-instance
parameters of the driver. Setting the parameters is
done on the command line with the ifconfig Mac OS X
command. The following parameters can be modified:

speed: (10,100,1000 Mbit/s)
role: (master or slave)
duplex: (half or full duplex)

Note that it is rarely necessary to set the parameters
on an adapter. The driver usually performs automatic
configuration of the link. In rare cases, however, it
is necessary to modify some settings.

Changing driver settings
------------------------

1. Make sure that you are root or have Administrator
   privileges.

2. Start the Terminal application located in the
   /Applications/utilities folder.

3. Type the following:

   ifconfig

4. Press return.

5. Locate your adapter by its IP address settings. The
   adapter name is "en" followed by a number, 1 for
   example.

6. To change the adapter speed setting to 100 megabits
   per second on adapter en1, type the following
   (exactly as written, including white space):

   ifconfig en1 media 100baseTX

7. Press return

To change other settings, such as duplex, type the
following (again, including all white space):

   ifconfig en1 media 100baseTX mediaopt half-duplex

and press return.
This will change your adapter settings to use half-
duplex mode.

To return your adapter to automatic speed settings,
type the following:

1. ifconfig en1 media autoselect

2. Press return

As before, make sure to use the correct interface
number on your machine. It isn't necessarily en1.

The medium values that can be set with the 'media'
keyword of the ifconfig command are displayed in the
last row of each interface's entry, prefixed with the 
word "supported media". For a Gigabit Copper card,
these are usually:

autoselect  (auto-negotiated speed)
1000baseTX  Gigabit without auto-negotiation
100baseTX   100 megabits without auto-negotiation
10baseT/UTP 10 megabits without auto-negotiation

The options that can be added with the 'mediaopt'
keyword of ifconfig are given in angle brackets after
each medium value. For example,

100baseTX <full-duplex>

means that 'full-duplex' (exactly as written here) is
a valid option after the 'mediaopt' keyword of the
ifconfig command.

The media option values that are currently supported
include:

full-duplex
half-duplex
flag0

where the keyword full-duplex (exactly as written
here) means a full duplex connection, half-duplex a
half duplex connection.
The keyword flag0 is only meaningful for Copper
adapters at 1000baseTx speed and determines whether
the adapter should operate as the master or the slave
on a connection without auto-negotiation.
For example, to set a non-autonegotiated 1000baseTX
connection with the D-LINK adapter acting as
master, type the following:

ifconfig en1 media 1000baseTX mediaopt flag0

To reset the flag0 flag, prepend a '-' to the
'mediaopt' keyword, ie.

ifconfig en1 media 1000baseTX -mediaopt flag0

For further information on how to use the ifconfig
command and its options please consult the online
manual pages for the ifconfig command by typing:

man ifconfig

                         ***End of Readme File***


